home *** CD-ROM | disk | FTP | other *** search
/ Internet Tools (InfoMagic) / Internet Tools.iso / applic / ncsa / tn3270 / rmac.helpcms.Z / rmac.helpcms
Text File  |  1989-11-18  |  7KB  |  134 lines
  1. .fo off
  2. .cs 1 on
  3.  
  4. RMAC
  5.  
  6. Use the RMAC command to upload Macintosh  files to CMS.   RMAC will upload text
  7. files and binary files.   In order to  use RMAC,  the Macintosh must be running
  8. Term for a modem connection, Mac3270 for a LocalTalk connection,  or tn3270 for
  9. a TCP/IP connection.
  10. .cs 1 off
  11. .cs 2 on
  12. The format of the RMAC command is:
  13.  
  14. ┌──────────╛──────────────────────────────────────────────────────────────────┐
  15. │          │                                                                  │
  16. │ RMAC     │ fn ft [fm]   [(options...[)]]                                    │
  17. │          │                                                                  │
  18. │          │ Options:                                                         │
  19. │          │     ┌           ┐  ┌           ┐  ┌           ┐                  │
  20. │          │     │Binary     │  │Menu       │  │Stdxlate   │                  │
  21. │          │     │NOBinary   │  │Nomenu     │  └           ┘                  │
  22. │          │     └           ┘  └           ┘                                 │
  23. │          │                                                                  │
  24. └──────────╩──────────────────────────────────────────────────────────────────┘
  25. .cs 2 off
  26. .cs 3 on
  27.  
  28. OPERANDS
  29.  
  30. fn        specifies the filename of the CMS file to be created.
  31.  
  32. ft        specifies the filetype of the CMS file  to be created.   If the first
  33.           character of the filetype  is a period,  a period instead  of a space
  34.           will separate  the CMS filename  and filetype  when they are  used to
  35.           form the  Macintosh file  name.   However,   the period  will not  be
  36.           included in the name of the CMS file which is created.
  37.  
  38. fm        specifies the filemode of the file to be created.   If no filemode is
  39.           specified, the file will be created on the user's A-disk.
  40.  
  41. OPTIONS
  42.  
  43. Binary    specifies  that the  file to  be uploaded  contains arbitrary  binary
  44.           data.  The contents of the file will be uploaded unchanged into a CMS
  45.           file with  fixed-length 128-byte records.    If necessary,   the last
  46.           record will be padded with hex zeros.
  47.  
  48. Menu      forces a standard Macintosh file dialog to be used to obtain the name
  49.           and location of the file to be uploaded.
  50.  
  51. Stdxlate  causes the standard  IBM ASCII/EBCDIC translation tables  to be used,
  52.           instead of the modified tables which are the default at Brown.
  53.  
  54. NOBinary  resets the Binary option described above.
  55.  
  56. Nomenu    specifies that  RMAC should not issue  a standard file dialog  on the
  57.           Macintosh if  a file matching  the CMS  fileid exists in  the current
  58.           directory.  This is the default.
  59.  
  60. USING THE RMAC COMMAND
  61.  
  62. When uploading files,  RMAC will treat the Macintosh file as either a text file
  63. or a binary file.   Text file processing is the default, and is appropriate for
  64. most ordinary files.  Uploading in this mode causes ASCII text to be translated
  65. to EBCDIC text in the CMS file, and causes line breaks to be preserved.
  66.  
  67. Binary mode,  invoked by  the Binary option,  causes the data  in the Macintosh
  68. file to be uploaded completely unchanged.   No translation is performed,  and a
  69. new line in the  CMS file is started after each 128  characters.   The CMS file
  70. will have fixed-length  records,  with hex zeros  used to pad the  last line if
  71. necessary.   This  transfer mode is primarily  intended for uploading  files in
  72. MacBinary format, as created by BinHex 5.0 and other programs.   It may also be
  73. used for binary files created by application programs.  However, editing may be
  74. required if hex zeros were used to pad the last line.
  75.  
  76. USAGE NOTES
  77.  
  78.   1) If a  file transfer  does not  begin after  the RMAC  command is  entered,
  79.      either file transfer  is not enabled in the Macintosh  program (applies to
  80.      Term  only),  or  the communication  path  between the  Macintosh and  the
  81.      mainframe does  not support a feature  RMAC requires (applies to  Term and
  82.      tn3270).  For Term, if a 3270 emulator is being used, it must support 7171
  83.      transparent I/O  or its  equivalent.   For  tn3270,  the  mainframe Telnet
  84.      server must support  3270 extended data streams.   To  resume the terminal
  85.      session,  press Enter  several times,  until RMAC responds  with the error
  86.      message "Retry count exceeded".
  87.  
  88.   2) When uploading files,  RMAC preserves the date the Macintosh file was last
  89.      modified.  The date is used to set the date the CMS file was last written.
  90.  
  91.   3) RMAC cannot create a CMS file with lines longer than 256 characters.  If a
  92.      longer line is encountered in the Macintosh file it is split into multiple
  93.      lines.  To identify these lines, RMAC prefixes all but the first line with
  94.      a cent sign character (hex 4A).   Cent signs cannot appear except for this
  95.      reason,  since  the standard ASCII character  set does not include  a cent
  96.      sign.
  97.  
  98.   4) Currently, RMAC reads only the data fork of Macintosh files.  Enhancements
  99.      are planned which will add the ability  to read both the resource and data
  100.      forks, and encode them into MacBinary format.
  101.  
  102. RESPONSES
  103.  
  104. Enter ABORT, CONTINUE, or SUBSET
  105.  
  106.           This response is generated when the user chooses "Interrupt Transfer"
  107.           on the Macintosh.    By entering one of the  three allowed responses,
  108.           the use can abort the file  transfer,  resume the transfer,  or enter
  109.           CMS SUBSET.   If CMS SUBSET is entered, the file transfer will resume
  110.           upon returning from SUBSET.
  111.  
  112. OTHER MESSAGES AND RETURN CODES
  113.  
  114.      DMSRMC001E Fileid incomplete or contains "*".  RC=24
  115.      DMSRMC002E Output file already exists.  RC=28
  116.      DMSRMC003E Invalid option 'xxxxxxxx',  RC=24
  117.      DMSRMC004E Mac error nnnn opening 'fileid'.  RC=100+Mac return code
  118.      DMSRMC005E Mac file 'fileid' not found.  RC=100+Mac return code
  119.      DMSRMC006E Error ...... from Mac read.  RC=100+Mac return code
  120.      DMSRMC007E Retry count exceeded.  RC=256
  121.      DMSRMC008I nnnnnn block retransmission(s).
  122.      DMSRMC009E Error nnnnnn from Mac close.  RC=100+Mac return code
  123.      DMSRMC010E Error from CP "SET" command.  RC=return code from CP
  124.      DMSRMC010E Error from CP "TERM" command.  RC=return code from CP
  125.      DMSRMC011E Transfer aborted by used.  RC=100+Mac return code
  126.      DMSRMC012E Remote system type is unknown.  RC=36
  127.      DMSRMC013E This version of Mac3270 (nn.nn) does not support file
  128.                 transfer.  RC=36
  129.      DMSRMC014E Mac3270 must be used for binary file transfers.  RC=36
  130.      DMSRMC069E Disk 'mode' not accessed.  RC=36
  131.      DMSRMC105S Error 'nnnnn' writing file 'fn ft fm' on disk.  RC=100
  132.  
  133. .cs 3 off
  134.